home *** CD-ROM | disk | FTP | other *** search
/ IRIX 5.3 for Indy R4400 / IRIX 5.3 for Indy R4400 175MHz.img / dist / eoe2.idb / usr / share / catman / u_man / cat6 / snapshot.z / snapshot
Text File  |  1995-02-28  |  15KB  |  265 lines
  1.  
  2.  
  3.  
  4. SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))                                                      SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      snapshot - save a portion of the screen in an image file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ssssbbbbiiiinnnn////ssssnnnnaaaappppsssshhhhooootttt [[[[----bbbb]]]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_n_a_p_s_h_o_t reads an area of the screen specified by the user, and saves it
  16.      in an image file.  To use _s_n_a_p_s_h_o_t, place the _s_n_a_p_s_h_o_t button window
  17.      someplace other than where you wish to grab.  Then, with the input focus
  18.      attached (i.e. the mouse is inside the _s_n_a_p_s_h_o_t window), hold down a
  19.      modifier key (shift, ctrl) on the keyboard to maintain the input focus,
  20.      and move the mouse to one of the four corners of the section of the
  21.      screen you wish to save. Now press lllleeeefffftttt mouse and continue holding it
  22.      down while you stretch out a red rubberband to the opposite corner of the
  23.      area of interest.  To tell _s_n_a_p_s_h_o_t to make the image file, go back to
  24.      the _s_n_a_p_s_h_o_t window, press the rrrriiiigggghhhhtttt mouse and choose one of the two
  25.      "Save" menu items.  You can repeat this sequence in various ways until
  26.      such time as you wish to exit.  At this point, you can choose one of the
  27.      two exit menu items with the rrrriiiigggghhhhtttt mouse.  To move the _s_n_a_p_s_h_o_t window
  28.      itself, use your favorite window manager accelerator functions, such as
  29.      ALT+F7.
  30.  
  31.      LLLLeeeeffffttttmmmmoooouuuusssseeee ffffuuuunnnnccccttttiiiioooonnnnaaaalllliiiittttyyyy
  32.  
  33.      The lllleeeefffftttt mouse button stretches, reshapes, moves or starts an entirely
  34.      new rubberband for you.  The cursor is the constant visual indicator of
  35.      what will happen if you press lllleeeefffftttt mouse.  As long as your input focus is
  36.      directed to _s_n_a_p_s_h_o_t you will see one of 4 different cursor types
  37.      depending on the location of the mouse:
  38.  
  39.      ccccaaaammmmeeeerrrraaaa ccccuuuurrrrssssoooorrrr ---- will appear when you are on top of any area of the
  40.      console screen other than on the sides or inside of the rubberband area
  41.      of interest.
  42.  
  43.      ccccoooorrrrnnnneeeerrrr ccccuuuurrrrssssoooorrrr ---- will appear when you are in the immediate vicinity of one
  44.      of the 4 corners of the currently placed rubberband.
  45.  
  46.      hhhhoooorrrriiiizzzzoooonnnnttttaaaallll////vvvveeeerrrrttttiiiiccccaaaallll ccccuuuurrrrssssoooorrrr ---- will appear when you are in the immediate
  47.      vicinity of one of the 4 sides of the currently placed rubberband.
  48.  
  49.      mmmmoooovvvveeee ccccuuuurrrrssssoooorrrr ---- will appear when you are fully inside the rubberband area.
  50.  
  51.      When your cursor is anywhere other than on top of the _s_n_a_p_s_h_o_t window,
  52.      whichever of the four cursors you see will tell you what will happen at
  53.      that point if you press the lllleeeefffftttt mouse button:  if you see the ccccaaaammmmeeeerrrraaaa
  54.      cursor this means that by pressing the lllleeeefffftttt mouse, you will start
  55.      creating a new rubberband that you can stretch out in any direction which
  56.      will stop when you let go of the mouse button;  when you see either the
  57.      hhhhoooorrrriiiizzzzoooonnnnttttaaaallll, vvvveeeerrrrttttiiiiccccaaaallll, or ccccoooorrrrnnnneeeerrrr cursors this means that pressing lllleeeefffftttt
  58.      mouse at this time will enable you to stretch the corner or side of
  59.      interest and continue doing so until you release the mouse button;  when
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))                                                      SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))
  71.  
  72.  
  73.  
  74.      the mmmmoooovvvveeee cursor is visible (while inside of the rubberband), pressing
  75.      lllleeeefffftttt mouse at this point enables you to move the entire rubberband in its
  76.      current shape and size until you let go of the mouse.  When you see the
  77.      mmmmoooovvvveeee cursor, you may also press mmmmiiiiddddddddlllleeee mouse to move the rubberband.
  78.  
  79.      To pop the _s_n_a_p_s_h_o_t button window, press down the lllleeeefffftttt mouse button while
  80.      your cursor is on top of the window, and release it without moving more
  81.      than one pixel in any direction.
  82.  
  83.      PPPPoooopppp----uuuupppp MMMMeeeennnnuuuu ooooppppttttiiiioooonnnnssss
  84.  
  85.      Snapshot uses the gl command ffffuuuullllllllssssccccrrrrnnnn(((()))) which has some "humorous" side
  86.      effects.  One of them is that unless the cursor is on top of the actual
  87.      window for the graphics program (in this case, the _s_n_a_p_s_h_o_t button
  88.      window), pressing rrrriiiigggghhhhtttt mouse will NOT bring up that program's menu.
  89.      Thus, to access the pop-up menu options, you must always bring the cursor
  90.      back on top of the _s_n_a_p_s_h_o_t button window before pressing rrrriiiigggghhhhtttt mouse to
  91.      access _s_n_a_p_s_h_o_t's pop-menu.
  92.  
  93.      The pop-up menu currently has five items defined:
  94.  
  95.      +o    The first item reads SSSSaaaavvvveeee ssssccccrrrrnnnn aaaassss ssssnnnnaaaapppp....rrrrggggbbbb if you have just started
  96.           up _s_n_a_p_s_h_o_t and have not yet swept out a rubberband.  This will
  97.           create an image file of the entire console screen (notice that at
  98.           this point there is a red rubberband that encloses the entire
  99.           console screen).  Or else it will read SSSSaaaavvvveeee aaaassss ssssnnnnaaaapppp....rrrrggggbbbb indicating
  100.           that a rubberband area of interest currently exists.
  101.  
  102.      +o    The second item--NNNNeeeewwww ffffiiiilllleeee nnnnaaaammmmeeee--will throw up a squat rudimentary
  103.           textport prompting you to input a new output image file name. If,
  104.           after having called up the textport, you decide you don't want to
  105.           change the output image file name, simply pressing carriage with an
  106.           empty string will exit the textport and not change the filename.
  107.  
  108.      +o    The third item--IIIIppppaaaasssstttteeee ssssnnnnaaaapppp....rrrrggggbbbb--allows you to paste up the image
  109.           you have most recently made.  Notice that after you have swept out
  110.           some sub-section of the screen with the red rubberband, but before
  111.           you have yet selected SSSSaaaavvvveeee aaaassss ssssnnnnaaaapppp....rrrrggggbbbb, the IIIIppppaaaasssstttteeee entry shows up as
  112.           a grey color instead of the solid black of the other menu items.
  113.           This is because you have not yet created the actual image file--
  114.           hence there is nothing for ipaste to lock on to out in the IRIS
  115.           universe.  Once you have chosen SSSSaaaavvvveeee aaaassss ssssnnnnaaaapppp....rrrrggggbbbb, then when you
  116.           pop-up the menu again, you will see that the IIIIppppaaaasssstttteeee menu item is now
  117.           solid black indicating that ipaste now has a fix on the currently
  118.           saved image file you have created.  The same thing will happen after
  119.           you have selected NNNNeeeewwww ffffiiiilllleeee nnnnaaaammmmeeee but before you save an image into
  120.           it.
  121.  
  122.           Notice that ipaste(1G) now recognizes the EEEEsssscccc key as a short-cut to
  123.           closing the ipaste image window.  This is especially useful when
  124.           ipaste is called with the ----nnnn option--as _s_n_a_p_s_h_o_t uses it--since
  125.           there is no border to specify a call to exit from.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))                                                      SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))
  137.  
  138.  
  139.  
  140.      +o    The fourth item--RRRReeeeddddrrrraaaawwww RRRRuuuubbbbbbbbeeeerrrrbbbbaaaannnndddd--will redraw the rubberband. This
  141.           is usefull for when something else erases the rubberband.
  142.  
  143.      +o    The fifth item--SSSSaaaavvvveeee aaaannnndddd EEEExxxxiiiitttt--will save whatever you currently have
  144.           selected, and then exit the program.
  145.  
  146.      +o    The sixth item--EEEExxxxiiiitttt--will simply exit the program without saving
  147.           anything that may be currently defined to be _s_n_a_p_s_h_o_ted.
  148.  
  149. NNNNOOOOTTTTEEEESSSS
  150.      There is a window constraint that affects _i_p_a_s_t_e(_1_G) which users of
  151.      _s_n_a_p_s_h_o_t will run into:  under 4Dwm, the minimum _i_p_a_s_t_e window width is
  152.      now constrained to be 88 pixels.  See the _i_p_a_s_t_e(_1_G) man page for more
  153.      details about why this is so.
  154.  
  155.      On machines having less than 24 bits available for RGB display, the
  156.      displayed image may appeared to have lost some quality.  This occurs when
  157.      the image that was saved was in colormap mode. The pixel color index is
  158.      expanded into the full RGB information. When redisplayed, the RGB
  159.      information is dithered on these machines to approximate the original
  160.      image.
  161.  
  162.      When you have selected the SSSSaaaavvvveeee ............ aaaassss ............ pop-up menu item and _s_n_a_p_s_h_o_t
  163.      is busy reading pixels, the cursor will change to an hourglass until this
  164.      proces s is finished.  Another visual cue (in case you move the cursor
  165.      elsewhere and let go of the input focus) is that the word "Snapshot" that
  166.      is written on top of the _s_n_a_p_s_h_o_t button window--which is normally
  167.      WHITE--turns to RED for the duration of the pixel reading/image file
  168.      building sequence.  It reverts to WHITE when the image file is completed.
  169.  
  170.      The ----bbbb option includes a bell-ringing audio cue which will then ringbell
  171.      with a short duration upon completion of every SSSSaaaavvvveeee operation.  The text
  172.      string "snapshot" which appears in the _s_n_a_p_s_h_o_t button window will always
  173.      turn RED when an image file is being created, and return to WHITE when
  174.      finished, but the ----bbbb ring-the-bell option was included for those wishing
  175.      to be more forcefully appraised that _s_n_a_p_s_h_o_t is ready for more input
  176.      action.
  177.  
  178.      Regarding what is actually saved into your image file, the pixels that
  179.      are underneath the red rubberband are NOT grabbed by _s_n_a_p_s_h_o_t. This means
  180.      that where specific pixel boundaries are critical, you must be sure that
  181.      what you want to make into an image file is exactly inside the red
  182.      rubberband--but not underneath these red border lines.  The one exception
  183.      to this is when the program is first invoked.  As mentioned above,
  184.      _s_n_a_p_s_h_o_t starts up with the default red rubberband set to the full
  185.      console screen.  In this case, if you select SSSSaaaavvvveeee ssssccccrrrrnnnn aaaassss ssssnnnnaaaapppp....rrrrggggbbbb, the
  186.      red rubberband will first disappear, then an image file of size
  187.      XMAXSCREEN by YMAXSCREEN will be created, and finally the red rubberband
  188.      will reappear.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))                                                      SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT((((6666DDDD))))
  203.  
  204.  
  205.  
  206. BBBBUUUUGGGGSSSS
  207.      It is possible under extreme circumstances to get fragments of the red
  208.      outline to remain on the screen. If this happens, place the red
  209.      rubberband over the fragments and then move the rubberband again.
  210.  
  211.      _s_n_a_p_s_h_o_t makes use of the fullscrn() GL command which, as the Reference
  212.      Manual warns, must be used "with caution or a sense of humor."  In this
  213.      case, caution is advised:  when wishing to access the pop-up menu, not
  214.      only must your cursor be moved back on top of the _s_n_a_p_s_h_o_t button window,
  215.      but to work as intended, you must release whichever key on the keyboard
  216.      you have been holding down to maintain the input focus while the cursor
  217.      has been outside of this button window.  Not releasing said keyboard
  218.      button will produce "humor[ous]" results when playing with the pop-up
  219.      menu.
  220.  
  221.      Another side effect of using fullscrn() while drawing the rubberband in
  222.      the overlay or popup planes is collision with other utilities also using
  223.      the overlay or popup planes. To restore the snaphot rubberband, select
  224.      "Redraw Rubberband" from the popup menu.
  225.  
  226.      _s_n_a_p_s_h_o_t is not yet smart enough to make sure there is enough free space
  227.      on the disk partition from where _s_n_a_p_s_h_o_t itself was originally executed,
  228.      before it blindly goes off and attempts to allocate enough memory to
  229.      build an image file of the area you specify.  Hence, if you find that an
  230.      image that you paste up on the screen looks "funny", run DF(1) to first
  231.      confirm that the disk partition that _s_n_a_p_s_h_o_t is running on has not had
  232.      all of its "avail" space used up.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.